﻿========================================================================
  ABAP2S4HANA - SAP S/4HANA 移行支援ツール  Version 0.1.0
========================================================================

  ソフト名     : ABAP2S4HANA - SAP S/4HANA 移行支援ツール
  バージョン   : 0.1.0
  作 者        : highdefinitionaudiodriver
  動作環境     : Windows 10/11, macOS 12+, Linux / Python 3.10 以上
  ライセンス   : MIT License（フリーソフト／オープンソース）
  種 別        : フリーソフト
  作成日       : 2026-06-09

------------------------------------------------------------------------
■ ソフトの説明 / 使用方法（README より）
------------------------------------------------------------------------

ABAP2S4HANA Migration Tool

A dual-mode (GUI and CLI) Python application for SAP ECC ABAP modernization assessment and S/4HANA migration support.

It scans ABAP assets, applies modernization rules, and generates reviewable conversion output plus impact analysis reports. The goal is to help teams identify compatibility issues, manual remediation points, and migration effort before a full S/4HANA project begins.

---

🎯 これは何？（30秒で）

- 誰のため：SAP ECC を運用中で S/4HANA 移行（2027年問題）を検討している情シス／SAP 移行プロジェクトのアセスメント担当 SI ベンダー
- 何が解決される：カスタム ABAP 資産の S/4HANA 互換性チェックを 数週間の手作業から数時間の自動レポートに短縮。SAP 純正ツール（SCMON / Custom Code Analyzer）で漏れる現実的な工数見積もりを補完
- なぜ既存ツールではダメか：SAP 純正は SAP ライセンス前提。本ツールは OSS で社内 PoC・第三者アセスメントに利用可能で、上司に出せる移行リスク評価レポートを出力
- 使う条件：Python 3.10+ / Windows・macOS・Linux／GUI または CLI

💰 想定ユースケース・価格帯

| 用途 | 形態 |
|---|---|
| 自社内 PoC・社内アセスメント | 無料（MIT） |
| ABAP カスタムコード診断レポート受託 | 応相談 |
| エンタープライズ S/4HANA 移行案件のアセスメント支援 | 個別見積もり |

---

Business Use Cases

- ECC to S/4HANA migration pre-assessment
- ABAP custom code inventory and compatibility risk analysis
- Impact reports for project estimates and stakeholder review
- Modernization proof-of-concept generation before production remediation

Features

- Dual-Mode Interface: Provides a user-friendly Tkinter GUI as well as a headless CLI mode for automated workflows.
- Syntax Modernization: Updates older ABAP syntax toward modern S/4HANA standards.
- Comprehensive Conversion Support: Identifies and assists with standard table, BAPI, and Function Module (FM) migration patterns.
- Impact Analysis Reporting: Generates detailed migration and impact analysis reports in HTML and CSV formats.
- Safe Execution: Automatically creates backups of your original source files before processing.
- Multiple Languages: Internationalized interface with built-in language settings.
- Highly Configurable: Configure source/target SAP versions (e.g., ECC 6.08 to S/4HANA 2023), file encoding, ABAP extensions, and SAP module filters (FI/CO, MM, SD, etc.).

Installation

1. Ensure Python 3.8+ is installed.
2. Clone the repository and install any required dependencies:
   
   pip install -r requirements.txt
   

Usage

GUI Mode
Simply run the application without arguments to launch the graphical user interface:

python main.py


CLI Mode
Use standard arguments to execute migrations directly from the command line:

python main.py -i <input_directory> -o <output_directory> [options]


Common CLI Options:
- -i, --input: Input folder containing ABAP files
- -o, --output: Output folder for converted ABAP files
- -e, --encoding: Source encoding (default: utf-8)
- --source-version: Source SAP version (e.g., ECC 6.08)
- --target-version: Target S/4HANA version (e.g., S/4HANA 2023)
- --module: SAP module filter (default: ALL)
- --report-format: Output format for the migration report (HTML, CSV, or Both)

Use python main.py --help to see all available flags for toggling modernization and backups.

Tests

Integration and conversion tests are provided. Run them using:

python test_conversion.py


---

🤝 商用利用・カスタマイズ依頼

- 個人・社内利用は無料（MIT ライセンス）
- 法人・自治体・SI 向け導入支援、カスタマイズ、診断レポート受託は応相談
- 連絡先：highdefinitionaudiodriver@gmail.com

<!-- CODEX-CURRENT-STATUS:START -->
現状サマリ (2026-05-25)

- 対象: ABAP2S4HANA Migration Tool
- 作業ブランチ: feat/sellable-v1
- README更新時点の参照コミット: 7c51f1f chore: add .gitignore to ignore test generated outputs
- Python 実行環境向けに requirements.txt を同梱。
- docs ディレクトリ配下に設計・運用・補足資料を配置。
- src ディレクトリ配下に主要実装を配置。
- 主要な確認コマンド: python -m pytest または README 記載の Python コマンド
- 次に進めるなら、README 内の利用手順と既存 docs / tests を起点に、未整備の検証手順・引き継ぎメモ・CI 化を補強する。
<!-- CODEX-CURRENT-STATUS:END -->

------------------------------------------------------------------------
■ 動作環境
------------------------------------------------------------------------
  Windows 10/11, macOS 12+, Linux / Python 3.10 以上
  ※ オンライン専用ソフトではありません（ローカル環境で動作します）。

------------------------------------------------------------------------
■ インストール / アンインストール
------------------------------------------------------------------------
  ・本アーカイブを任意のフォルダに展開してください。
  ・詳細な起動手順は上記「ソフトの説明」および同梱の README を参照してください。
  ・アンインストールは展開したフォルダを削除するだけです（レジストリ不使用）。

------------------------------------------------------------------------
■ 転載・再配布について
------------------------------------------------------------------------
  本ソフトは MIT License のオープンソースです。同梱の LICENSE 条文に
  従う限り、自由に利用・改変・再配布できます。
  なお Vector 以外の配布サイトへの無断転載はご遠慮ください。

------------------------------------------------------------------------
■ 免責事項
------------------------------------------------------------------------
  本ソフトの使用によって生じたいかなる損害についても、作者は一切の
  責任を負いません。利用者ご自身の責任においてご使用ください。

------------------------------------------------------------------------
■ 著作権
------------------------------------------------------------------------
  Copyright (c) 2026 highdefinitionaudiodriver
  本ソフトは MIT License の下で公開されています。

------------------------------------------------------------------------
■ 連絡先 / サポート
------------------------------------------------------------------------
  作 者        : highdefinitionaudiodriver
  E-mail       : highdefinitionaudiodriver@gmail.com
  GitHub       : https://github.com/highdefinitionaudiodriver/ABAP2S4HANA.git
  不具合報告・ご要望は上記 E-mail もしくはリポジトリの Issues へ
  お願いいたします。

========================================================================
